d払い(継続課金) ファイル送信仕様
d払い継続課金では、当サービスから加盟店様へ日次で課金ファイル、申込状況ファイルを送信します。
送信先は当サービスショップ管理画面の、メニュー「継続決済」>「docomo継続課金」>「設定」にて設定します。
それぞれのファイルは12:00までに加盟店様へ送信します。ただしメンテナンスや障害発生時には遅延する可能性があります。また、検証環境では12:00以降にファイルが送信されます。
加盟店様からの正常応答が確認できなかった場合は60秒ごとに5回再送します。
日次課金ファイル
対象データがある場合のみ、ファイル作成前日にドコモで処理された課金データの処理結果を日次でショップID単位に作成します。
ファイル出力対象
日次課金ファイルに出力される決済情報は以下の条件です。
・ファイル作成前日にドコモセンターで確定、変更、取消された課金データ
ファイル情報
日次課金ファイルは、ヘッダ、データ(課金データ件数分)、フッタの3種類のレコード構成となります。
出力パラメータ(当サービス⇒加盟店様)
fileContents | 必須 ファイル
ファイル日次課金ファイルを返却します。
※ファイルの文字コードはUTF-8となります。 |
■ファイル情報
ファイル名 |
"C_"+ショップID+"_"+処理日(yyyymmdd)+ランダムの数字※+".csv"
C_9999999999999_2022091663419.csv ※ランダムの数字:0~9223372036854775807の範囲 |
区切り文字 |
半角コンマ
|
改行コード |
CRLF
|
ソート順 |
オーダID,課金月の昇順
|
囲み文字 |
ダブルクォート
|
■ヘッダレコード
レコード区分 | 必須 半角英字2桁
"HD"固定となります。
|
ショップID | 必須 半角英数13桁
ショップIDを設定します。
|
データレコード件数 | 必須 半角数字8桁
データレコードの件数を設定します。
|
■データレコード
ショップID | 必須 半角英数13桁
|
オーダーID | 必須 半角英数記号27桁
|
課金月 | 必須 半角数字6桁
課金月をyyyyMM形式で返却します。
|
取引状態 | 必須 半角英字15桁
取引状態を返却します。
【SALES:課金済み】 【CANCEL:キャンセル】 【INVALID:無効】 |
利用金額 | 必須 半角数字6桁
|
税送料 | 必須 半角数字6桁
|
キャンセル金額 | 半角数字6桁
|
キャンセル税送料 | 半角数字6桁
|
取引ID | 必須 半角英数32桁
|
取引パスワード | 必須 半角英数32桁
|
ドコモ課金番号 | 必須 半角数字18桁
|
ドコモ加盟店注文番号 | 必須 半角数字20桁
|
処理期限 | 必須 半角数字14桁
処理期限をyyyyMMddHHmmss形式で返却します。
|
エラーコード | 半角英数3桁
|
エラー詳細コード | 半角英数9桁
|
処理日時 | 必須 半角数字14桁
処理日時をyyyyMMddHHmmss
|
■フッタレコード
レコード区分 | 必須 半角英字2桁
"FT"固定となります。
|
入力パラメータ(加盟店様⇒当サービス)
RecvRes | 必須 半角数字1桁
受信結果以下のいずれか
0:受信OK 1:受信失敗 |
申込状況ファイル
当月有効な継続課金申込みデータを日次でショップID単位に作成します。
ファイル出力対象
申込状況ファイルに出力される決済情報は以下の条件です。
・契約中の申込みデータ
・当月末で解約となる申込みデータ
ファイル情報
申込状況ファイルは、ヘッダ、データ(課金データ件数分)、フッタの3種類のレコード構成となります。
出力パラメータ(当サービス⇒加盟店様)
fileContents | 必須 ファイル
ファイル申込状況ファイルを返却します。
※ファイルの文字コードはUTF-8となります。 |
■ファイル情報
ファイル名 |
"R_"+ショップID+"_"+処理日(yyyymmdd)+ランダムの数字※+".csv"
R_9999999999999_2022091663419.csv ※ランダムの数字:0~9223372036854775807の範囲 |
区切り文字 |
半角コンマ
|
改行コード |
CRLF
|
ソート順 |
オーダID,課金月の昇順
|
囲み文字 |
ダブルクォート
|
■ヘッダレコード
レコード区分 | 必須 半角英字2桁
"HD"固定となります。
|
ショップID | 必須 半角英数13桁
ショップIDを設定します。
|
データレコード件数 | 必須 半角数字8桁
データレコードの件数を設定します。
|
■データレコード
ショップID | 必須 半角英数13桁
|
オーダーID | 必須 半角英数記号27桁
|
取引状態 | 必須 半角英字15桁
取引状態を返却します。
【REGISTER:契約中】 【RUN-CHANGE:変更処理中】 【RUN-END:契約終了処理中】 【END:契約終了】 |
利用金額 | 必須 半角数字6桁
|
税送料 | 必須 半角数字6桁
|
変更利用金額 | 半角数字6桁
|
変更税送料 | 半角数字6桁
|
ドコモ表示項目1 | 全半角40バイト
|
ドコモ表示項目2 | 全半角40バイト
|
ドコモ決済番号 | 必須 半角数字12桁
|
加盟店自由項目1 | 全半角100バイト
|
加盟店自由項目2 | 全半角100バイト
|
加盟店自由項目3 | 全半角100バイト
|
取引ID | 必須 半角英数32桁
|
取引パスワード | 必須 半角英数32桁
|
ドコモ加盟店注文番号 | 必須 半角数字20桁
|
ドコモ端末区分 | 必須 半角英字2桁
お客様の端末区分を返却します。
【SP:SPモード】 |
Wi-fiテザリング接続 | 必須 半角数字1桁
お客様のWi-fiテザリング接続状況を返却します。
【0:Wi-fiテザリング接続なし】 【1:Wi-fiテザリング接続有】 |
確定基準日 | 必須 半角数字2桁
|
初月無料フラグ | 必須 半角数字1桁
初月無料フラグを返却します。
【0:初月有料】 【1:初月無料】 |
終了月無料フラグ | 半角数字1桁
終了月無料フラグを返却します。
【0:終了月有料】 【1:終了月無料】 |
継続課金終了日 | 半角数字14桁
継続課金終了日をyyyyMMddHHmmss形式で返却します。
|
エラーコード | 半角英数3桁
|
エラー詳細コード | 半角英数9桁
|
処理日時 | 必須 半角数字14桁
処理日時をyyyyMMddHHmmss
|
■フッタレコード
レコード区分 | 必須 半角英字2桁
"FT"固定となります。
|
入力パラメータ(加盟店様⇒当サービス)
RecvRes | 必須 半角数字1桁
受信結果以下のいずれか
0:受信OK 1:受信失敗 |